package cn.highedu.coolshark.product.service;

import cn.highedu.coolshark.common.PagedVO;
import cn.highedu.coolshark.product.pojo.dto.BrandAddNewDTO;
import cn.highedu.coolshark.product.pojo.dto.BrandQueryParamDTO;
import cn.highedu.coolshark.product.pojo.dto.BrandUpdateDTO;
import cn.highedu.coolshark.product.pojo.vo.BrandListItemVO;
import cn.highedu.coolshark.product.pojo.vo.BrandStandardVO;

import java.util.List;

/**
 * 处理品牌的业务接口
 */
public interface IBrandService {
    /**
     * 查询品牌列表
     * @return 品牌列表, 如果没有响应的品牌, 返回一个集合长度为0的列表
     */
    List<BrandListItemVO> list();

    /**
     * 分页查询品牌列表
     * @param brandQueryParamDTO 封装分页查询相关数据
     * @return 分页数据
     */
    PagedVO<BrandListItemVO> list(BrandQueryParamDTO brandQueryParamDTO);

    /**
     * 启用品牌
     * @param id 品牌ID
     */
    void setEnable(Long id);

    /**
     * 禁用品牌
     * @param id 品牌ID
     */
    void setDisable(Long id);

    /**
     * 根据品牌id, 删除品牌数据
     * @param id 尝试删除的品牌的id
     */
    void delete(Long id);

    /**
     * 添加品牌
     * @param brandAddNewDTO 品牌数据
     */
    void addNew(BrandAddNewDTO brandAddNewDTO);

    /**
     * 根据品牌ID, 修改品牌详情
     * @param id 品牌ID
     * @param brandUpdateDTO 新的品牌信息
     */
    void updateInfoById(Long id, BrandUpdateDTO brandUpdateDTO);

    /**
     * 根据ID获取品牌详情
     * @param id 品牌ID
     * @return 匹配的品牌数据详情, 如果没有匹配的数据, 返回null
     */
    BrandStandardVO getStandardById(Long id);

    /**
     * 根据类别id查询相应的品牌列表
     * @param categoryId 列别id
     * @return 品牌列表
     */
    List<BrandListItemVO> listByCategory(Long categoryId);
}
